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* * 

* NOTE * 

* * 

* Before goin,<; any further, please mBke * 

* copies of any disks tliat came with your * 

* 3UPERCL0CK II. Then store tiie orifjinsls * 

* in a s.ifs place. * 

* * 

************************************************** 



INTFiODUCTlOK 

The SUPERCLOCK II represents an excitin!* addition to yOLir Apolc 
conputer. Besides its usual function of supDlyin<!; the date and 
time, the SUPERCIOCK tl can also add new dimensions to the Apple 
by generating precise interrupts for fore!;round/backp:round 
progranning. Automatic date stamping of files In both BASIf^ and 
Pascal is also possible with the incUided softvvarc. The entire 
oUPERCLOCK i! system will be described in this jrianual. Some 
portions may not be applicable if you did not purchase the 
optional softv.'are. 

The follov/in.ij items should have been included in this packs^ie: 

1 SUPERCLOCK I I board 

1 SUPEPCLOCK SYSTEM diskette (SPC-D102) 

1 Operatinf!; Manual 

The SUPERCLOCf; SYETE?^ diskette contains utility and denonst rat ion 
pro^rai^s for using the clock in DOS 3.2, 3.3, Pascal, and CP/^'.. 
The front side is formatted as IG sector and contains both Pascal 
and DOS 3.3 programs; the back side is 13 sector for DOS 3.2 
operation and also serves as a backup copy. Please note that 
neither DOS 3.3 nor the Pascal files necessary for bootin=! are 
present on this disk. Therefore, DC NOT ATTEMPT TO BOOT THE FROf-.'T 
SIDE. The back side of the disk has the BASiC proKrams formatted 
in DOS 3.2.1. This side contains DOF. and can be booted. Copy the 
appropriate side(s) of this diskette onto one or more blank disks 
and then prepare the copies as follows. 

PREPARING A i. 2..! SUPERCLOCK JJ. SYSTEM MASTER 

DOS 3.2.1 users should make a copy of the back side of the 
SUPERCLOCK SYSTEf! diskette. Then transfer the proftram UPi^ATE 
3.2.1 supplied by Apple onto this copy. 

PREPARING A 5. J, SUPERCLOCK ii SYSTEM MASTER 

1. Make a copy of your DOG 3.3 System Master supplied by Apple 
and then boot it. 2. Insert the SUPERCLOCK Ii disk (SPC-D102) 
and type LOAD I NSTALL {if you do not have Inte.f^er basic, type 
LOAD SNSTALL.FP ). 3. Reinoye the SUPERCLOCK disk and replace it 



with the copy of the DOS 5.3 Master. Type SAVE INSTALL and after 
it is finished type RUM (if you get a DISK FULL error, just 
UfJLOCH and DELETE a lar-e file such as PHONE L!ST), k. The 
INSTALL program is self-prompting and uses Apple's Master Create 
utility. See below for a complete description of the options 
available. After entering the required information (type HELLO 
for the sreetins: program's name), SUPER-DOS will be installed on 
your Systen Master. 5. When completed, hit ESC and then RETURH 
to re-boot the System Master, novj with SUPER-DOS. 6. You can nov; 
place SUPER-DOS on any of your existing 3.3 DOS diskettes by 
RRU-Ining Master Create on this disk. One of the first disks you 
may wish to update is a co^iL of the 5UPERCL0CK SYSTEM diskette 
since it has no DOS. The greeting program on this disk also 
cal led HELLO. 



I N STALL OPTIONS 

SUPERCLOCK II SLOT - Must be set to the proper slot in which 

the clock is located (1-6). Default = S;. 
SUPERCLOCK I I HODE - Must be set to the same mode as the 

clock (M=norraal ;A=ACE). Def3uU = N. 
TIME AMD DATE - Specifies vyhether the time as well as the 

date should be stamped on each file, 

Defaul t=N. 
LANGUAGE CARD FIX - This is a fix for 3.3 DOS so that the 

Language Card need not be reloaded every 

time you boot. Default=Y. 

PASCAL UTi LITY DISK 

Make another copy of the SUPECLOCK SYSTEM diskette and label it 
WSE; (you can use any copy program, either from Pascal or DOS). 
This WSE: Pascal Utility Disk will contain the following files 
that allow you to use the SUPERCLOCK II in the Apple Pascal 
Operating environment: 

WSE: 

SYSTEM. L I BRARY - Complete Jibrary routines including UNIT 

SUPERCLOCK. This library must be on the 

boot disk when compiling programs that use 

the clock. 
AUTOBOOT.TEXT - Pascal program for automatic jjreeting and 

update of Filer, 
SYSTEM. STARTUP - Compiled codefile for above program renamed 

to SYSTEM. STARTUP for immediate execution 

when booting. 
SAf-iPLEi.TEXT - Short Pascal program to display time. 
SAMPLE].. CODE - Compiled codefile for above. 
LSBRARY/1.0 - Library for Pascal I.O users. 

We suggest that you transfer WSE : SYSTEM. L I BRARY and 
SYSTEM. STARTUP onto a copy of APPLElt and use this disk for 
booting. Apple Pascal 1.0 users should transfer WSE : L I PRARY/1 
to APPLElrSYSTEM. LIBRARY and then re-compile AUTOBOOT.TEXT into 
SYSTEM. STARTUP. 
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INSTALLATION 

Before installinj; the SUPERCLOCK II into your cotnputer, exani ne 
the board to become familiar v.'i th the function of the 
di pswi tches. 



SWITCH OH (iLE) 

SET Clock setting 
enabl ed 

ADJ Resets seconds 
to 00 

f'ODE Selects ACf: mode 



OFF (down) 
Setting disabled 

fJormal position 

HormaT mode 



The last svn tch is unused and 
switches is down or OFF, 



the normal position for sll 



After turning off the computer, remove the cover by gently 

pullin;; up at the back. The SUPFRCLOCK li can nov^ be placed in 

any slot axce.nt 0; slot k is recommended. Do not replace the 
cover until the clock has been set, 

5FTT1MG THE CLOCK 

To set the clock, the switch marked "SET" must be moved to the O!-' 
position. Now run the clock setting program supplied. Folloiv the 
directions in the program to set the clock to the correct local 
time. Note that an data to and from the clock is expressed 
numerically. In particular, the day of vieek is represented by a 
number from D-6 as shown below: 



Sunday 

Monday 

Tuesday 

VJednesday 

Thursday 

Friday 

Saturday 



After setting the clock, return the "SEl" sv.'itch to the OFF 
position to prevent accidental changes to the clock. 
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p. F APING I!i£ CLOCK 

The SUPERCLOCK Ij contains firmware that makes reading; the clock 
from BASIC extreneJy easy, in short, whenever the SI.'PERrLOCK' s 
slot is selected for input (i.e. JN^n in BASIC, n CTi^L-K from the 
monitor, etc.), it will return a string of characters containinK 
the date ami time in this forinat Cassumins NORMAL mode): 

W MM/DD/YY HH;MM;SS 

[ \ / \ / 
(day of week-i date time ) 

Semicolons are used in the time display because Applesoft cannot 
handle colons on input. Note that when reading the clock, the 
computer win echo the input (i.e. print it on the screen) just 
as if it were being entered from the keyboard. !f you want to 
read the clock without having it echo to the screen, use the 
command PR#n. This sends all output to the SUPERCLOCK where it is 
"dumped." Don't forget to reset normal keyboard input and screen 
output with 1M*0 and PR#0 after reading the clock. Of course, 
vvhen usins DOS, these commands must be preceded with a CTRL-D and 
placed in a PRINT statement. 



When inputtins the clock data into a string, both !N#n and PRSn 
should be used. Then read the clock with a statement in the 
form: 

INPUT " ",Tft (Integer BASIC) 

INPUT " '•;!$ (Applesoft) 

Note that a space is first printed to the clock board. This will 
ensure compatibility between Integer BASIC and Applesoft and also 
between other clock boards. Various components of the time can 
then be extracted using the appropriate string functions (see 
Integer BASIC and Applesoft manuals). 

NORMAL MODE INTEGER APPLESOFT 

WEEK!)AY?=TS<1,1) VJEEKDAYS = LEFT? (TS, 1) 

M0NTHS=T<S(3,IO M0NTH$=MID?;(T<:,3,2) 

DAY$=TSC6,7) DAY$=MI DS (TJ, 6, ? ) 

YEAR$=T!?C9,10) YEARS=HI D$(T'S, n, 2 ) 

HOUR*=TS (12,13) H0UR*=MIDS(IS,12,2) 

MINUTE<!;=TS(15,16) Ml NUTE$=Mio* (IS, 15, 2 ) 

SECONDS =T$( IS, iq) SECON!}'!:=R|(5HTS(TS,2) 

Study the sample programs supplied for further clarification on 
how to use the SUPERCLOCK II. 



ij - 



APPLE CLOCK EMULATIOM ( ACE ) MODE 

To take advantage of the many programs ivrltten for the Appl'^ 

Clock from Mountain Hardware, the SUPERCLOCK I! has incorporated 

an Apple Clock Emulation mode. This mode is selected by novinf- 
the switch marked "MODE" to the ON position. The major 

difference betv-reen modes is in the format of the datii 

presentation from the clock. The Apple Clock uses the follov/inr 
format : 

MM/DD HH;MM;SS.minm 

{ date tine milliseconds ) 

in the ACE mode, the SUPERCLOCK M uses this format: 

MM/DD HH;MM,;SS.WYY 

i / "^ ■ / IT 



( date time | '-year ) 
day of week 

Thus the only difference between the tv;o clocks is that the day 
of week and year diijits appear Instead of milliseconds. In this 
mode, the various components of the string can be extracted as 
shown b e 1 ov.i . 



ACE MODE INTEGER APPLESOFT 

WEEKDAYS=T$(16,TE) WEEKDAYS«MI OS (T*, 3 6, 1) 

MONTHS=TS C 1 , 2 ) MOHTH* = L E FT S ( TS , ? ) 

DAYS=T$Ct(,5) DAYS=M,ID*(T?,U,:?) 

YEAR«;=Tlttl7) YEARS=R 1 GHT^CT*, 7) 

H0UR<:=TSC7,S) H0URS=MID'?:(T?,7, 2) 

MIMUT£!:;=T?;C1.C,11) M.I NUTES=M! D?. (TJ, 10, ?) 

SEC0MDS=TSC13,11|) SECOMD!^=Hi Df (Tit, 13, 2 ) 

It is also possible to convert the string representation of the 
data from one mode to another. For example, the followini^ line 
xvill allovj an Applesoft program written for the Apple Clock to be 
used with a SUPERCLOCK II in either mode: 

IF MID*(T<S;,8,1)="/" THEN T£=M! D$ (T*, 3, 5 }-!-M[ De{TS, 11, g) + " . onn" 

This line should be added Just after the portion of the orogram 
that reads the clock. If the program also has an Apple Clock 
slot-finding routine, it may not work when the Sl'P£??CLOCK M is 
in the NORMAL mode. Therefore, you should replace it with thp 
SUPERCLOCK II slot-finder. 



13 


2C 


IS 


6S 


13 


D7 


1 R 


C5 


22 


F8 


21; 


6? 



SUPKRCLCQCK I I SLOT FINDER 

The subroutine at the end of the clock settinfT prograiris can be 

used to automatically determine in which slot your SUPEP.CLOCK II 
is located. To allow compatibility with the Apple Clock and to 

pronote consistency in prosranis that use the SUPERCLOCK 11, the 

following bytes in the PROM firmvjare should be used by slot 
finding routines: 



TO FIND BYTE I S ANO BYTE i S 

ClOCli 

Clock in NORMAL node 

Clock in e i ther mode 



it 
or Apple Clock 



ACCURACY AND 3D SECOMD AOJUSTMFNT 

Your SUPF.RCLOCK li was adjusted at the factory to provide 
accuracy within a couple of minutes per year. If the clock is 
consistently gainin.i; or losing; time, you may wish to adjust the 
trimmer "CS" at the upper right corner of the board. Using 3 
small screwdriver, turn the trimmer VFRY SI, IPI'TLY clockwise to 
speed up the clock, counter-clockv/i se to slow it down. 

Additionally, the SUPERCLCCK II can be synchronized to the 
correct time by using the svjitch marked "ADJ." Moving this switch 
to the OM position will momentarily reset the seconds to 00, 
adding one minute if the seconds v^ere greater than 30. Return 
this switch to the OFF position after adjusting the clock. 



0N - 80ARD BATTERY 

The SUPERCLOCK M contains a fJiCd rechargeable battery to 
maintain timekeeping v^hen the computer is off. This battery is 
automatically charged v.'henever the computer is on and under 
normal use will not require attention. If you remove the 
SUPERCLOCK from the computer or leave it off for more than three 
months at a time, then the battery may require a full recharging. 
This can be accomplished by leavinj; the computer turned on for 
2ii-3f hours. 
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READIHG IHE CLOCK; FROM ^'1ACI!l^;i: LANCUArii; 

This section is for those wishing to incorporate the GUPHRCLOCk 
I! into their rnachinge 1 an.c;L!a.n:e prosrans. The sinplcst \:sy to do 
this is by accessinf; the PROi-^ firmware on the clock. For exfinplf, 
the prorirain belov,' v-m 1 1 read the data from the clock into r- st'rin^ 
of RAM locations: 



1000- 


AS 


38 


LDA 


*38 


1002- 


48 




PHA 




1003- 


AS 


39 


LDA 


*3? 


1005- 


48 




PHA 




1006- 


A9 


00 


LDA 


#*0 


1008- 


85 


38 


STA 


*38 


lOOA- 


A9 


C4 


LDA 


S*C4 


lOOC- 


35 


39 


STA 


*39 


SOOE- 


A2 


13 


LDX 


t**13 


1010- 


20 


iS FD 


JSR 


SFDIS 


1013- 


9D 


81 02 


STA 


*02S1 ,X 


1016- 


CA 




DEX 




1017- 


10 


F7 


BPL 


*1010 


1019- 


68 




PLA 




lOlA- 


85 


39 


STA 


*39 


lOlC- 


<S8 




PLA 




lOlD- 


85 


38 


STA 


438 


lOlF- 


60 




RTS 





Note that this routine assumes the clock to be in the ACE mode. 
In fact, the location of the RA'^ buffer was chosen to match the 
fornat used by the Apple Clock. Thus you may find this routine 
helpful In interfacing the SUPERCLOCK M to machine lan.Tu.^'^e 
prograrris written for the other clocks. l.'hcn your prof^raiTi must 
handle the clock in either mode, it is usually best to write a 
complete driver routine, independent of the firmware. An ejomole 
of this cap be found in the VISIO.S file on the SUPERCIXCK SYSTEf' 
disk (it loads at ?itCO0; clock entry to read time is SijCOF and 
interrupt control rs done through StiC03). 



INTERRUPTS 



Refer Co the data sheet of the 6820/6S21 for completf? details on 
interrupt handling. The following interrrupt frequencies are 



avfii 1 sbl e; 



CAl - 1021) Hz (approx. 1 per mS) 

CA2 - 1 Hz (1 per second) 

CBl ~ 1/60 Hz (1 per minute) 

Cf32 - 1/7600 Hz (1 per hour) 



PfA addresses can be determined as follows: 



PORT A - $COgn + 5nO 

CRA - $0081 + SnO <n=SUPERCLOCK slot) 

PORT B - $C022 * SnO 

CRB - $C0?3 + SnO 

A simple example of interrupt handling may bs found in our 

millisecond tinin,^ routine, MSRTN. The source code for this 

pro^rain is on the next page. Refer to it as you rea^i the 
foilowing description of the Important sections. 

Lines 270-5^1') comprise a slot-finding routine. Then lines eon-B'ie 
set up the Apple's I f?0. interrupt vector at location S3FE-5FF. The 
address of your interrupt handling routine should be placed herp, 
lov; byte first. Next we initialize the SUPERCLOCK's PIA in lines 
6!i0-7S0, The important points here are: 1) set up the Data 
Direction Reffisters^ 2) enable the PIA to pass the appropriate 
interrupt signals, 3) enable the actual signals from the clock, 
and then, 4) clear the PJA interrupt flagCs). This last function 
is accomplished by performing a "dummy" read of the port 
associated with the given interrupt signal. Finally, the OL I 
instruction is executed and interrupts are enabled. 

When an interrupt occurs, the CPU will begin executing your 
Interrupt routine as pointed to by S3FE~3FF. This routine should 
alv/ays restore the accumulator from location tkS and perform 
another "dummy" read to clear the interrupt flai; Just prior to 
returning via the RTl instruction. Of course, any other registers 
used should be saved at the beginning, and then restored^at the 
end, of your routine. 
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SUPERCLQCK XI AND PASCAL 

(Jsinj* tho SUPERCLOCK il with Apple Pascal is greatly simplified 
by iiavin.t; the cloc!< routines in tlie system library, Thp file 
'.■;SE:SYSTHf'". LI I3RAP,Y contains all of the nornal routines plus the 
addition of UNIT SiJPERCLOCK. You can give your profrrams access to 
the clock by simply ndding the following statement just after the 
PPOGRAI' heading: 

USf^S SUPERCLOCK; 



This 1 i ne 
descr i bed 
decl ared; 



effectively adds 3 external procedures which are 
belov-;. The following global variables are also 



D01J,M0N,DAY,YR,ilR,H!M,SEC 
TIME, D [ SKNAME, LASTBOOT 
CLOCKPRESEMT 



I NTECER 

STRINC; 

BOOLEAK 



PROCEDURE READCLOCK; 

This procedure will read the SUPERCLOCK II and assign to each 
variable data corresponding to the current date and time. 



DOV.f - Day of week CO. , 
MOH - ^<onth (1. .12) 
DAY - Day of month CI, 
YR - Year CO. ,99) 
HR - Hour CO. .23) 
Mm - Minutes C0.,?;9) 
SEC - Seconds CO. ,59) 



5) 
.31) 



This data will also be formatted into a string by a call 
procedure TIMESTRIMG (see below). 



to the 



PROCEDURE TIMESTRIMG; 



This procedure takes the data stored in the variables MOM. 
and creates a string in the format 



, SEC 



MK/DD/YY HH:MH:SS 

This string is then assigned to the variable TIME. Note that the 
day of V'jeek information Ts not used. This procedure can also be 
used to convert any integer data into a string; Just set up the 
variables MON..SEC as desired before calling TIMESTRING. 
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PROCEDURE UPDATE {voH; 

This procedure expects to be passed one parameter of tyne 
INTEGER. If the value of this parameter is a volume number for a 
disk drive C i .e. U, 5,9, 10, 11, 12) , then the corresponding disk will 
be updated, if possible, v;ith the current date and time. The 
volume name of the disk will also be read and assigned to the 
variable DISKHAM.E. Similarly, the date and time of last boot (or 
whenever the disk was last UPDATEd) is stored in the string 
LASTBOOT. Finally, the Filer is updated to reflect the current 
date for saving files. 

Note that the seconds digits are not stored on the disk and that 
when UPDATE reads a time of last boot, it will shov,' the seconds 
equal to 00. Also note that whenever the Filer writes to the 
disk, the time of last boot stored on the disk will be set to 



SUPERCLQCK JJ. AFiO CP/M 

The SUPERCLOCK II may be used under the CP/I^ operating system 
vi/ith the appropriate software. From MRAS t C or GBASIC, this is 
most easily done by POKEing in a short interface routine. Two 
examples of this are provided in the files CPMDE^^Cl and 2. These 
are normal Apple text files vjhich can be converted to the CP/K 
system by use of the APPOS utiity (see the CP/M documentation). 



DESCRl PTION OF FILES ON IHE SUPERCLOCK ! ! DISK (SPC-D102) 



CLOCK FACE 

CPMDEMOs 

DATE & TIME 
Ht-RES CLOCK 

IMTERRUPT DEMO 
MS DEMOs 
MSRTH 
QUIZ BEI^O 
SET CLOCK 
SLOT-FIMDER 



STATUS 

TIHEFILE 
TIMER I LER 
VISI PATCH 



Binary file containinfr the hi-res picture of a 
clock used by the HI -RES program. Do not BRU". 
Text files of sample pros^rams showing how to 
use the clock from CP/f^ Basic. 
Demonstration of clock reading techniques. 
This is an Applesoft proRirair; that uses hi-res 
graphics to display a clock with moving hands. 
Program that explains and executes STATUS, 
Demonstrations of millisecond timing. 
The actual millisecond routine used by above. 
Shows how to put a time limit on input. 
BASIC program to set clock for correct time. 
Text file of SUPERCLOCK slot finding routine. 
Can be added to any Integer or Applesoft 
program by simply typing EXEC SLOT-FINDER. 
Routine that places time and date at the top 
of the screen using interrupts. Can be BPUN. 
Text file used by TIN'EFILER program. 
Keeps track of when disk v;as last booted. 
Program to modify VisIDex (from VisiCorp). 
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** SjJPER-DOS ** 



iiOT£: All RAf' nddresses given in this section are for a 48K (or 

Languaije System) Apple II or Apple II Plus. For 32K machines, 

subtract fiinoo (IST'f.'j decimal); IfiK maciiines subtract Sgnao 
(327G8 decir^2l ). 



JNTRODIJCTIO^J 

SUPER-DOS, in conjunction vnth the SUPERCLOCK M , acids an 
exciting new dimension to Apple's Disk Operating System CPOS 
5.2,1. or 3.3) - automatic tirae/date stamping of files as they 
are stored on the disk. This feature is similar to that found on 
most large computer systems and the Apple Pascal Operating 
Systen. Because we have incorporated this feature directly into 
the normal Apple DOS, there are no special instructions necessary 
for using SUPIIR-DOS. In fact, you probably w\ ] ] not be aware that 
you're using SUPER-DOS until you type CATALOG. 

US I HG SUPER - DOS 

If you haven't already done so, boot your SUPERCLOCK 11 System 
Master {see page 1 for how this disk is made). Now practice 
savin.PT and loading files under SUPER-DOS. Note how the current 
date (and time) is automatically stored in the catalog and that 
when accessing files, you do not need to type in the date as part 
of the filename. The only new restriction is that filenames are 
now limited to 23 characters {slightly less when time is also 
added) as opposed to the normal 30 - not much of a sacrifice. 

After you are acquainted with the operation of SUPER-DOS, you can 
then use the MASTER CREATE (3.3) or UPDATE 3.2.1 program from 
Apple to transfer this new DOS to your existing diskettes. Note 
that only the DOS is changed; any programs on the disk will not 
be harmed, Hovyever, as with any software product, it is alvjays a 
good idea to make a back-up copy of a disk before updating it. 



COMPATI Bl L!TY VMTH RE6ULAR DOS 

After updating a regular DOS diskette, all programs on that disk 
vn 1 1 remain intact and there vjill be no problem using them v/ith 
SUPER-DOS. Of course, there vjon't be a date associated vjith the 
cxising files (created before the use of SUPER-DOS), but new 
files stored on the disk ivi 1 1 automatically be dated. If a SAVE, 
BSAVE, RENAi^E, or OPEN command is performed on any exising file 
(whether it previously had a date or not), the current date will 
be stored in the catalog by SUPER-DOS. The IK'IT command will also 
cause the booting (or "HELLO") program to be saved with the date 
that the disk was initialized. 



It is important to note that all files saved under SUPER-DOS are 
directly downward-compatible i-yith regular DOS. If you ever hanpen 
to be running without SUPER-DOS and v.'ish to access a dated file^ 
you can eitiier use tiie normal cursor copying function to include 
the dats in the filenanne, or a simpler approach is to type: 



POKE -1^5^65,21 



For time and date 



POKE -19905,15 

POKE -nn65,is 



(Normal ) 
<ACE) 



This will make re;;ular DOS ignore the date in all subsequent 
commands (i.e. until another regular DOS diskette is booted). 
This POKE is worth remembering if you don't plan on updatin<; all 
of your disl<ettes. 

You may also wish to know that if SUPER-DOS does not find a 
SUPERCLOCK n in the expected slot and mode, it will continue to 
function except that whenever it tries to store a date, it will 
just put in blanks. This could remove existing dates from files 
unless the updatini; feature is disabled (see next section). If 
you ever must remove the clock or change its defaults, either 
notify SUPER-DOS (with the appropriate POKEs ) or boot un i-i th a 
regular DOS diskette. 

FURTHER OPERATiN(; HINTS 

When transferring files between diskettes, it is best to use a 
copy program with a wildcard specification feature (such as 
Apple's FID or FISHHEAD). This win allow easy selection of the 
fjles and will assure that the original date of each file is left 
intact. LOADlng and then SAVEing ivould of course transfer the 
file with the current date instead. 



When using text files, any time the file is 
updated. If you wish to defeat this feature 
text file), use the following commands: 



OPENed it will be 
(eg. vjhen REAOinr; a 



DISABLE UPDATING 
RESTORE UPDATING 



DOS 3.2.1 

POKE -17166,20? 
POKE -17165,l!tf( 



DOS 1-1 

POKE -1?709,20? 
POKE - IS 709, Hi U 



If you wish to disable dating of new flies, type 



DOS 1.2.1 



DOS 3.7 



TURN OFF 
TURN ON 



POKE -17213,0 
POKE -1721?, 215 



POKE -187(;1,0 
POKE -1S7G1,21; 



n - 



OPT I or; A I TIME-CLOCK JJ. 1 NSTRUCT 1 QMS 



NOTE: This disk is on 3.2 SUPER-DOS. Ttie programs herein may be 
MUFFIMed to 3.3 (preferably SUPER-DOS). 



FIRSTTjME USE, When you first boot the TIME-CLOCK ii diskette, 
you win !>e presented with a blanl< menu of jobs. At this point 
use the A)dd command Cjust press the 'A' key) to add one or more 
jobs. For each job you will be asked for a job number (0-999), 
client name (0-13 characters), and the name of the program used 
for running this job. For example, if you used your Apple PIE 
word processing program to write contracts for ABC, inc., you 
might enter: 

JOB NUMBER: 100 

CLIENT NAME: ABC. INC. 

PROGRAM NAME: APPLE PIE 

If the program you wish to run is on a protected disk or is 
otherwise incapable of being executed by a RUN or BRUM, you can 
type PR#6 (or other appropriate slot) for the program name. This 
win have the effect of booting the application program diskette. 

RUNNING A PROGRAM. From the TIME-CLOCK I! program, typing 'R' 
for Run fonowed by a Job number, win automatically log on the 
desired job and, if the required program is on the same diskette, 
it vyI 1 1 begin executing. Otherwise you will be prompted to place 
the appropriate application disk in the drive and hit RETURN. 
When you are finished with this job, you must replace the TiME- 
CLOCK (I disk back in the drive (if it was removed) and RUN LOGOFF 
or just boot the disk. Application programs written in BASIC can 
usuany be modified to automatically run LOGOFF when they are 
finished. Look through the program listing for where the program 
normaHy ends (usuany with an END statement). Replace this with 
the following statement; 

PRINT "dRUN LOGOFF" (d=CTRL-D) 

i-G.GOF,Fj. This program calculates how much time you've spent on 
each session and records this information to the disk. You will 
have the option to change the STOP, and thus the ELAPSED, times 
if they are incorrect (eg. you took a 5 minute break v^hile on the 
phone ) . 

TJMER. This is a general purpose elapsed timer program that can be 
used with the TIME-CLOCK tl program to record time spent on activ- 
ities other than the computer. For example, a lawyer wishing to 
keep track of office visits could define a job number with the 
client's name, and then enter TIMER for the program name. 
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3LIST 

lO REH *t SUPERCLOCK II DATE & TIME *t 

20 HOME 

30 GQSUB 30000 

40 PRINT " YOUR SUPERCLOCK IS IN SLOT '■ ; SLOT 

50 PA = - 16256 + SLOT « 16 

60 PB = PA + 2 

65 CA = PA + i;CB - PB + 1 

70 INVERSE : VTAB 23: PRINT " PRESS ANY KEY TO STOP "; 

: NORMAL 
SO VTAB 21: PRINT 

90 PRINT ■' IN#";SLOT: REM CTRL-D IN QUOTES FDR DOS 
100 PRINT " PR#";SLOT 
110 INPUT A* 
120 PRINT " PR#0" 
130 PRINT " IN#0" 

140 IF MIDS <A«,8,1) = "/" THEN 160 
150 A* = MID* (A*,:6,l) + " " + LEFT* <A*,5) + "/" + RI6HT* (A*, 2) + 

MID* (A*, 6, 9): REM CONVERT FROM ACE MODE IF NECESSARY 
160 RESTORE : VTAB 6 

200 REM *« DAY OF WEEK ROUTINE ** 
210 FOR I = 1 TO 7 
220 READ DUMMY* 

230 IF I = VAL { LEFT* <At,l)) + 1 THEN DW* = DUMMY* 
240 NEXT I 

250 DATA SUNDAY, MONDAY, TUESDAY 
260 DATA WEDNESDAY, THURSDAY, FRIDAY, SATURDAY 
270 REM 

300 REM «« MONTH ROUTINE tt 
310 FOR I = 1 TO VAL < MID* <A*,3,2)) 
320 READ MO* 
330 NEXT I 

340 DATA JANUARY, FEBRUARY, MARCH 
350 DATA APRIL, MAY, JUNE 
360 DATA JULY, AUGUST, SEPTEMBER 
370 DATA OCTOBER, NOVEMBER, DECEMBER 
380 REM 

400 REM tt AM/PM ROUTINE «* 
410 P* = "" 

415 TA = PEEK <CA):TB - PEEK <CB) : POKE CA,4: POKE CB,4 
420 POKE PB,53 
430 PM = PEEK <PA) 
440 POKE PB,47 

445 POKE CA,TA: POKE CB, TB: PM = PM ~ INT <PM / 16) * 16 
450 IF PM > 7 THEN 480 
460 P* = " AM" 

470 IF PM > 3 THEN P* = " PM" 
480 REM 

500 PRINT : PRINT SPC < 20 - LEN (DW*) / 2);DW*;" 
510 D* = MQ« + " '■ + MID* <A*,6,2) + ", 19" + MID* (A*, 9, 2) 
520 PRINT : PRINT SPC ( 20 - LEN <D*) / 2)jD*;" 
530 TIME* = MID* (A*, 12,2) + ":" + MID* (A*, 15,2) + ": " + MID* <A*, IS 

,2) + P* 
540 PRINT : PRINT SPC ( . 20 - LEN (TIME*) / 2); TIME* 
S50 IF PEEK ( - 16384) < 128 THEN SO 
560 POKE - 16368,0 
570 END 

30OOO REM SUPERCLOCK II FINDER 

3001O I =- PEEK f - 12289): REM KILL ALL ROMS 
30020 SLOT = O: I = 1 
30O3O IF PEEK ( - 16350 + I « 256) = 248 AND PEEK < - 16348 + I * 256 

) = 104 THEN 3O06O 
30040 1=1+1: IFI<8 THEN 30030 

30050 PRINT "I CANNOT FIND A SUPERCLOCK II": SOTO 30O7O 
30060 SLOT = I 
3007O I = PEEK ( - 12289): RETURN 
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INTERNAL CONTROLS 



Thcirt" .yn jiy locadons iviihin tiic PlA acc^s^iljre to iho 
WIPU (lat^ bvi' Iwo fpi-rphcrot RtgiitCJ's, livO DsJa 
Oirpc^iort ficgiswrs, and iwo Control R«jimcj-5. ScltciiOfi 
of thKP locjiiorhs iscortuoired by the RSOaiid RSl inputs 
lOgiMhCr wilh bit 2 if^ rhe Conuo! RcgiMC^, as shown 
inTsWo 1, 

TABLE 1 - IWTSRNAl. ADDRESSING 



i^Sl 


REO 


nrtrm 


rol 


Lac.->'.iar\. ^fitcTt^a 


CF!A-2 


CRB? 








1 X 


Ccnplyc'i)^ Rt^rnci A 











X 


D.i:.i Directicin Rt^iswf -> 


a 


t 


X 


K 


Co:>lioiRr^.Mef A 


1 





- X 


Prrjp[i«:!l RtqiiSf?: E 


1 





X 





OnuOir^^ciwnReg.w^B 


^ 


' 


X 


X 


COf>iFO!Ri^i-:ipi B 



INrTlALIZATION 

A low tpwt iine hni The t'Jtect ot ?tfOirir| aii PIA fcgis 
icfs. Thii well SL( PAO-PA?. PBO-Pe?. CA2 ar.d CS? ^s 
tn;)tus, 3!id all interrupi; disabled, Hv. PIA muil Iw COn- 
frgiitctl durtny the tc^tar? proyiartt which follows she [*!5e;. 

Otljfli of p>0s5ibii: CCirifiguriiHOr^s Of ihc Oala Dfrccrfon 
and Conirol ftogisior ;(rc 9^ (nUowi. 

DATA DJRECTIOM REGISTERS (DDRA and ODRB) 
The two DntJ Dircclion Rcgtslcfi alSow Ih€ K'iPli to 
coi^troi the th^oction ot dJi3 ihfoug!^ tiich coej-e&poncfing 
pertphtfial dai.i line A D-n-i DjrcciJon Rcgisiw t>ri sei 51 
"0" CCu'vhqures lite t;0irCMJ0nrfin9 pcnphCro! dau !tnc iis 
sn ir.[>u:, "3" fcstflis tn ,-in ouiput. 



CONTROL REGISTERS (CRA OfidCRB) 

The iwo Conii-ol Rogiitcfs {CRA and CRBJ iillow the 
MPU to cortlrol llip oppralron of ihc four ppnphe'al 
conuof hnes CA1. CA3. CBl snd CB2 In adtlttron ^hev 
allow ihe MPeJ !q irnstire ihc inTf;r:j.ipi lines Jnd mornSOr 
Iho si.-nus oi tht fnioj^rupi Mags Bits Ihrough & ol ^h{^ 
I1.TO togrstecs mjv t>t- writtcrb o( read by ihc WPU when 
the pfopef chip SCJgCT o^<l register sctett sigf^als 5ri.i 
.ipplrcd. Bits 6 and 7 of The- iwo frgsstcfs a'e i-cad ottty 
.ir>d .T'c motfi'ltc! by CXItrrtial irttctrup's occui ring on 
control ir.^ci CAl, CA?. CSl or CB3 The fpim^t of the 





yABt.E 3 


"COl^TftOL w&ftD FOP MAT 




■/ 


n 


s H 1 3 


^ 


- 1 


CRA 


inCA^ 


ifia.\? 


CA^Ci^rtSioi 




CA I Coivlrol 




? 


& 


5 j 4 j 3 


? 


-n 


CRS 


IRQRl 


iTimj 


C&?Crtr^lfO[ 




cm ci.'-i'o; 



D^to Direction Accesj Control Sit (CRA'2 and CRB'2) - 
Bi; 7 in eoch Control rrgt^ic-r {CRA and CRB1 iillows 
jcliiciior^ of cithci & Pcifpheial Interface Rcgisi.?: or ihe 
Data D'tccT-on Re^lsie* whtri ittc pfOj>ef fCgistc! scJsci 
signals are apyficd to RSlJ ar:d S5 1 

Interrupt Flags {CR A-6. CR A-7, CR B 6, af>d CR &7) 
The. iouf {fhlOfrUpt f >3g bils die set by aclivo transitiDiis of 
sEgnals on the fooi imcirupt and Ppnpheiol Cciitrot lines 
svher^ those Imci srt pioarammo^l to be inputs Thcw; bus 
cinrjot be jet direrily from the VrPU Data SuS ,irvd srC 
fesei fOdftcttly by o Head Pciiphciat Data Opci^ition on 
ihp 3pproprioie sectton 



TABLE 3 -CONTROL OF INTERRUPT INPUTSCAl AWD C81 



CRA-i 
(CRB-l} 


CRA.O 
(CRB'O) 


Inlcrrupl Input 
CAS jCfll) 


Entorrupi Fl^g 
CRA-7 {CRB-71 


MPU Inlcrrupl 

Request 
fR?3S(ffi5g) 








: /\rl!vc 


Sot h:^_;h or. ■ 0! CAl 


Ois&bt'^d — FSQ re- 
mains high ; 


1 


: Atitvc 


S(>: hr,!;^t an , ur GA1 
tCB5> 


GOOP tow ivrjcn tho 
fCfiS-7j goes tiiOh 


1 


' AClLvC 


Sn hr<;!) on ^ o! GAt 


Oisabfod — IHO re- 
main ^ high 


1 1 


: Aoiivc 


Set hiqh on ; 0! CAt 
(CBl) 


Goe^ fow ivhen 'ho 
inl5?rfUDi ilail bf! CRA.-7 
(CRe-?! goes hi^h 






■ in^Ticotes owiiii-E- t(.l^s;:1c^r^ vof^ 10 r-ig^j 

; sf^i-c-ire? negsij'.'e ['a^siJiOJi (rufj^ loiowf 

r.lr Smorrujil IFact hit CRA-? 15 cleared by ;:n WPU Rtjd ol ihe A Dala RogiSICi. 

ant; CRB r r^ c!c.v*?d by .-in MPU Read 0^ t!>ft B Daii^ Rcgtsler 

n CRA-0 {Cfta-0) is lowwhcn an inlt-jrupt occtfrs (rntctnjp! rftsaWcd) ano hS laler brought 

hiQh, IROA \\r6b) ■accuii ^fKf C^n-^ tCft6 0) I'^vfiatccy w a "ona'- . 



MOT<?FtC>LA SGmiconcttJCtOr Rrt>{itJOT^ fnc 



Control of CAT jjnd CBI Inierrgpt Inpu; i.dn«5 (CRAO. 
CflB 0, CRA 1, arid CRBD - The iwo Iowcjt ord*.-! bds 
ot ihL' c<}(^t^ol mgrttcri ms us^ti to conKol ^l^e v-tteinifH 
input 3!ni;j CM and CB^ B^is CRAO v-^d CRBO j^e 



uw:d tocn^bk- (hi; MPU inttjtiupl si^rial^ IftOA and IROS, 
respyciivcly giu CRA-1 3iid CRS 1 di:;i<?rminy iht* oc^ivt 
transllion of the mioirufjl muul viqrials CAI and CBl 

iToljlr: 3). 



tABLt -J - CONTROl. OF Ca2 AWp CBZ AS INTtftKUf t iWPUTS 



CRA-S 

<CRa.S) 


CHA-4 i CRA-3 
(CHB-JJ i iCRB-3) 


Intfirrupl Input Iniorcupt Flpg 
CA2 (CB2} i CPA-6 <CRB-6) 
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J, 
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; Ac:i^jfr 


Scl hjg:: or^ ' 0! CA:^ 
lCB2; 
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r.it',dr«! bj. an WIPU Read cl iw 3 D;ii:t Retjisio; 

tl CFiA-3 (CRB-3J is iow wti^n {in inteffiipT occurs (iriii 
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